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SUBJECT 
Release 4.0 of the Systems Network Architecture (SNA6) Program Products 


SOFTWARE SUPPORTED 


This document supports Release 4.0 of the SNA6 Product Set operating under 
Release 4.0 of the MOD 400 operating system or Version 1.0 of the HVS 6 PLUS 
operating system. 


ORDER NUMBER 
GZ68-02 7 January 1987 


Honeywell 


This Seftware Release Bulletin (SRB) provides release- 
specific information needed by data processing managers, 
system administrators, system personnel, and programmers. 
Tt Supplements the release-independent reference material 
documented in product manuals. An associate manual, the 
Customer Support Handbook (Order No. GT10), covers general 
information on ordering manuals, reporting problems, and 
requesting Honeywell assistance. 


In this SRB, the terms "SNA6 system" and "SNA6 node" 
refer to a DPS 6 or DPS 6 PLUS minicomputer executing 
Honeywell SNA6 software and operating as a node in an SNA 
network. Honeywell SNA6 systems are referred to as SNA6 
nodes to distinguish them from IBM SNA nodes. 


Honeywell disclaims the implied warranties of merchantability and fitness for a particular 
purpose and makes no express warranties except as may be stated in its written agreement 
with and for its customer. 

In no event is Honeywell liable to anyone for any indirect, special or consequential damages 
The information and specifications in this document are subject to change without notice. 
Consult your Honeywell Marketing Representative for product or service availability. 
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PRODUCT DESCRIPTION 


This section provides a brief description of each of the SNA6 
program products. These products are: 


SNA6 Transport Facility (SNA6-TF) 

SNA6 Remote Job Entry Facility (SNA6—-RJE) 

SNA6 Interactive Terminal Facility (SNA6-ITF) 
SNA6 File Transfer Facility (SNA6-FTF*) 

SNA6 Application Interface Facility (SNA6-AIF) 
SNA6 Remote Operator Facility (SNA6-ROF) 
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The SNA6 program products also include the DSA/SNA Gateway 
Interface Facility (GWIF) providing internetworking capabilities 
between SNA and DSA networks. (DSA is Honeywell's Distributed 
Systems Architecture network system.) GWIF software is described 
in a separate Software Release Bulletin (DX99). 


On DPS 6 and DPS 6 PLUS systems, SNA6 program products can 
operate concurrently with non-SNA6 software, including BSC, DSAO, 
PVE, and RNP products. 

Marketing Identifiers 


The following Marketing Identifiers (MI) apply: 


Program Product MIs 
SNA6 (includes SNA6-TF/ITF/RJE/AIF/ SHC225 
FTF-6/ROF-6) 

Transport Facility (SNA6-TF) SHC192 
Interactive Terminal Facility (SNA6-ITF) SHC194 
Remote Job Entry Facility (SNA6-RJE) SHC196 
Application Interface Facility (SNA6-AIF) SHC2 82 
Remote Operator Facility-6 (SNA6-ROF-6) SHC294 
File Transfer Facility-6 (SNA6-FTF-6) SHC226 
SNA-Host (includes SNA6—-ROF-H/SNA6-FTF-H) SHC291 
Remote Operator Facility-Host (SNA6—-ROF-H) SHC292 
File Transfer Facility-Host (SNA6-FTF-H) SNC190 


* In some publications SNA6-FTF is referred to as SFT; the 
components SNA6-FTF-6 and SNA6-FTF-H are referred to as SFT-6 
and SFT-H, respectively- SNA6-FTF is also referred to 
generically as UFT (Unified File Transfer). 
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PRODUCT DESCRIPTION - Continued 


SNA6 Transport Facility (SNA6-TF) 


The SNA6 Transport Facility provides the base functionality 
necessary to support communications between an SNA6 system and an 
IBM host in a Systems Network Architecture (SNA) network. The 
SNA6 Transport Facility is prerequisite software for any SNAG 
program product. 


The SNA6 Transport Facility provides the following functions: 


0. 


A Configurator that creates installation specific 
configuration tables from SNA host and SNA6 node 
information provided by the customer. 


Transmission Services that provide support for: 


IBM Physical Unit Type 2 

Data Link Control Layer of SNA 

Path Control Layer of SNA 

Transmission Control Layer of SNA 

SNA Data Flow Control 

Host generated requests for maintenance statistics 
Switched and dedicated communications lines 
Multipoint configurations 

Multiple Host Connections 

Multiple SDLC links 

NRZI support on MLC-16 only 

Both half-duplex (HDX) and full-duplex (FDxX) 
Transmission Modes 

Transmission Subsystem (TS) Profiles 3, 4. 5, and 7 
Function Management (FM) Profiles 0, 3. 4, 5, and 19 


Administrative Control Services that support operator 
control (SOPR) of the SNA6 product set. This includes 
commands to: 


Provide status of all active lines, nodes and logical 
units 

Collect and display both error and traffic statistics 
Enable/Disable DARTS trace for PU/LU 

Systematically terminate all active sessions, program 
products, and the Transport Facility. 


In addition, all error and status change messages are 
jOurnalized in a central sequential log file. 
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PRODUCT DESCRIPTION - Continued 
SNA6 Remote Job Entry Facility (SNA6-RJE) 


The SNA6 Remote Job Entry Facility appears to the host as an 
IBM 3777 Model 3 Remote Job Entry Terminal. In an SNA 
environment, Remote Job Entry data streams are transmitted from a 
remote SNA6 system to the host for processing. Printed reports 
and card output are returned from the host to the SNA6 system. 


SNA6-RJE in conjunction with the SNA6 Transport Facility. 
provides Logical Unit Type 1 communication with multiple hosts, 
and supports multiple SNA Physical and Logical Units. Each 
invocation of SNA6-RJE can support up to six concurrent Logical 
Unit sessions with attached devices. The number of SNA6-RJE 
logical nodes is limited only by SNA or by resources available on 
the SNA6 system. 


SNA6-RJE emulates a controller of one or more devices and a 
console. Standard DPS 6 or DPS 6 PLUS devices provide standard 
3777 workstation functions. 


SNA6-RJE supports the following devices: 


Card Readers 

Card Punches (written to disk) 
Serial or Line Printers 

Disk Units 
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SNA6 Interactive Terminal Facility (SNA6-ITF) 


The SNA6 Interactive Terminal Facility allows an SNA6 system 
to appear to the host as an IBM 3274 Control Unit Model 51C with 
relevant devices attached. Up to 32 devices (displays and/or 
printers) can be configured per invocation of the Interactive 
Terminal Facility (ITF). Honeywell WST/VIP asynchronous 
terminals and workstations with 1920-character displays appear as 
IBM 3278 Model 2 terminals, and Honeywell dot matrix and line 
printers appear as IBM 3287 printers to the host system. The 
number of ITF invocations is limited only by SNA or by resources 
available on the SNA6 system. 


SNA6-ITF, in conjunction with the SNA6 Transport Facility. 
provides communication with multiple hosts and supports multiple 
SNA Physical and Logical Units per invocation. In addition to 
the features inherent in the IBM 3274, SNA6-ITF supports: 


Multiple hosts 

Logical Unit Type 1 (SCS printer support) 
Logical Unit Type 2 (3270 terminal) 

Logical Unit Type 3 (3270 data stream printer) 
User Program Exits 

Multiple keyboard types on VIP terminals 


O0O0000 
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PRODUCT DESCRIPTION - Continued 
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SNA6 File Transfer Facility (SNA6-FTF) 


SFT consists of two components: SNA6-FTF-H that executes on 
the IBM Host and SNA6-FTF-6 that is an AIF application executing 
on the SNA6 system. SNA6-FTF-6. requires AIF. 


SNA6-FTF-6 
SNA6-FTF-6 supports the following functions: 


o Transfer an IBM user file to a new or existing file on the 
SNA6 system 

Transfer an SNA6-resident file to an IBM host 

Rewrite an existing SNA6-resident file 

Append to an existing SNA6-resident file 

Delete an SNA6d-resident file 

Rename an SNA6—-resident file 

Execute an EC file on a SNA6 system. 


Oo0000 0 


SNA6-FTF-6 provides the functions necessary to support file 
management features and file transfers to and from an IBM host 
system. 


The supported file structures are UFAS sequential- indexed, 
relative and non-UFAS fixed relative files (bound units) - 
SNA6-FTF-6 responds to the host resident software (SNA6-FTF-H) 
which defines all operations to be carried out by the file 
transfer process. 


SNA6-FTF-6 and the DSA6 Unified File Transfer Facility 
(DSA6-UFT) share several common modules, thus affording some 
reduction in memory requirements for concurrent operations. 


SNA6-FTF-H 

SNA6-FTF-H transfers files between a host system and an SNA6 
system. In addition to the basic transfer process, this facility 
provides access to the following file management functions: 
rename file, delete file, and execute command file. 

SNA6-FTF-H software includes the following: 


o A Transmission Control Program (TCP) to monitor and 
control the file transfer. 


Oo Support for a 3270 operator interface. 
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PRODUCT DESCRIPTION - Continued 


Oo A File Maintenance Utility (FMU) to perform the following 
auxiliary functions: 


- Define the SNA6 system resources that can use the file 
transfer function 


- Define the work to be done within each file transfer 
session and the date/time that each session should 
occur 


- Prepare data for transmission including data 
compression and/or translation between EBCDIC and ASCII 


- Generate reports of the results of transmission, as 
well as statistical information 


- Process data received from the SNA6 node into user 
specified files including data decompression and/or 
translation between ASCII and EBCDIC. 


SNA6 Application Interface Facility (SNA6-AIF) allows COBOL 
or Assembly language programs, executing on the SNA6 system. to 
communicate with CICS or IMS (LU Type 0 only) transaction 
programs at the IBM host. 


SNA6-AIF supports an application-to-application interface for 
LU Type 0 users. The session can use any feature of SNA that is 
defined by: 


o Session type zero Function Management (FM) profile 4 and 
Transmission Services (TS) profile 4 


o How CICS treats a full function logical unit 

o How IMS treats a secondary logical unit programmable. 

SNA6-AIF also supports advanced program-to-program 
communications for LU Type 6.2 basic conversations with host 
transaction programs. SNA6-AIF supports a full set of the LU 


type 6.2 basic conversation verbs (and most of the option verbs) 
that support a hierarchical connection. 
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perator Facility (SNA6—-ROF) 


The SNA6 Remote Operator Facility (SNA6-ROF) allows a network 
operator. who is locally or remotely connected to an IBM host, to 
have a conversation with SNA6 nodes. The ROF consists of two 
components: SNA6-ROF-H. residing on the IBM host, and 
SNA6-ROF-6, residing on the SNA6 node. SNA6-ROF-6 is an AIF 
application. 


SNA6—-ROF Supports two types of users: a remote user and a 
remote operator. The remote user has access to the following: 


ECL commands 
Line Editor 
Patch utility 
DARTS. 


O000 


In addition, the remote operator can do the following: 


Execute OCL commands 

Monitor console activity at the SNA6 system 
Perform SOPR commands 

Configure SNA6 nodes remotely (batch configurator) 
Execute CSCAN. 


o0O0 00 


SNA6-ROF-H supports an IBM administrator who is responsible 
for starting and stopping LUS on SNA6-ROF-6 nodes and for 
monitoring and controlling activity on those nodes. 


SNA6-ROF-H includes support of IBM printers. 


This release of the Systems Network Architecture 
(SNA6) program products contains all maintenance 
fixes applicable to Release 1.2 through Update 05. 
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PRODUCT ENHANCEMENTS 


This release provides the following enhancements over 
Release 1.2. 


SNA6 Transport Facility (SNA6-TF) 
Oo Supports the HVS 6 PLUS Version 1.0 operating system. 


oO The SOPR "STATUS" command has been enhanced to display LU 
Type 6.2 information. 


Oo The SNA6 Configurator has been enhanced to support the LU 
Type 6.2. 


SNA6 Remote Job Entry Facility (SNA6-RJE) 


o Release 4.0 has been updated for maintenance purposes only 
and contains no functional enhancements over Release 1.2. 


SNA6 Interactive Terminal Facility (SNA6-ITF) 
oO The user can change LU classes at the time of login. 


o The Interactive Terminal Facility now allows the user to 
dynamically spawn a Class 2 application through an EC or 
application program. 


SNA6 File Transfer Facility-6 (SNA6-FTF-6) 


o The SNA6 File Transfer Facility-6 has been revised to 
allow for execution in Swappools, time-sliced, and 
multiprocessing environments. In addition, SNA6-FTF-6 now 
makes use of AIF LU Type 0 functionality. AS a result, 
SNA6-FTF-6 can reside on the same physical unit as other 
AIF applications. 


SNA6 File Transfer Facility-Host (SNA6-FTF-H) 


Oo Release 4.0 allowS communications with both SNA6-FTF-6 
Release 4.0 and SNA6-FTF-6 Release 1.2. 
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‘PRODUCT ENHANCEMENTS ~ Continued 
SNA6 Application Interface Facility (SNA6-AIF) 
o The Application Interface Facility has been enhanced to 
Support LU Type 6.2 basic conversation verbs in COBOL and 
Assembly language interfaces to host transaction programs. 


o The following LU Type 0 session calls have been added. 


Assembly Language COBOL 


SSACPT CSACPT 
SSGTAT CSGTAT 
SSPOLL CSPOLL 


SNA6 Remote Operator Facility-Host (SNA6-ROF-H) 


The group logical unit (GLU) configuration file has been 
changed to a VSAM ESDS file from a sequential file. This 
eliminates the use of DCT (transient data queues). The 
installation instructions reflect this change. 
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MINIMUM REQUIREMENTS/DEPENDENCIES 


Hardware Requirements (DPS 6 or DPS 6 PLUS) 


The SNA6 Program Product Set Release 4.0 requires the 
following minimum equipment: 


O 


Minimum equipment necesSary to support the MOD 400 Release 
4.0 operating system or the HVS 6 PLUS Version 1.0 
operating system. Refer to the GCOS 6 MOD 400 Executive 
Release 4.0 Software Release Bulletin (GJ0O1-01) or the HVS 
6 PLUS Version 1.0 Software Release Bulletin (US51-00). 


VIP73XX, VIP78XX, VIP/20X, or HDS-2 asynchronous terminals 
Multiline Communication Processor (MLCP), or the MLC-16 
Communications Controller, or a network controller (DPS 
6/22) 


Asynchronous communications line adapter (for terminal 
connection) 


HDLC line adapter (For SDLC connection) 


CIP or CIPSIM for AIF COBOL programs, SNA Configurator, 
and SNA EDIT utility 


Modem or direct connect cable 


Increased system and user memory pool space (see "Memory 
Requirements") 


Minimum Equipment Requirements (Host) 


O 


Minimum equipment necessary to support the following IBM 
Operating systems or software environments: 


—- MVS/SP Version 1 Release 3.8 

—- SMP/4 

- AMS/VSAM Release 3.8 

- ACF/VTAM Version 1 Release 3.0 
-~ ACF/NCP/VS Release 2.1 and 3.0 
- NCCF 1.2/NPDA Release 2.1 

-~ CICS/OS/VS Version 1.6.1 

- IMS 


9 GZ68-02 


MINIMUM REQUIREMENTS/DEPENDENCIES - Continued 


Software Requirements 


SNA6 TRANSPORT FACILITY (SNA6-TF) 


The SNA6 Transport Facility Release 4.0 requires GCOS 6 
MOD 400 Release 4.9 or HVS 6 PLUS Version 1.0 aS an operating 
system base. The SNA6 Transport Facility is requisite software 
for any of the other SNA6 program products. 


o The Transport Facility Release 4.0 Software consists of 
the following bound units: 


- >>SYSLIB2>SNA 

- >>SYSLIB2>SNAMAP 
~ >OSYSLIB2>SNEDIT 
- >>SIDOZNBINT 

- >>SID>ZQLSCI 

- >>SID>ZNLSHC 

~ >>SID>ZNLSNC 

- >>SID>ZNLSMC 

- >>ZSNA>ZNBSLN 

~ >>ZSNA>ZNSOPR 

- >>ZSNA>ZNCONF 


The following files are used with the User Productivity 
Facility (UPF) and the SNA configurator directory: 


- >>CCD>SOPR DTA 
- >>CCD>CNF>START UP.EC (used by UPF only) 


The SNA6 Transport Facility Release 4.0 provides the 
following DARTS files: 


~- >>SIDSDARTS DBF 

= J2PSID-E Le TICs 

= >?oLlD?LG.TICS 

= PPoevDPC. TICs 
SNA6 REMOTE JOB ENTRY FACILITY (SNA6-RJE) 

The SNA6 Remote Job Entry Facility Release 4.0 requires GCOS 

6 MOD 400 Release 4.0 or HVS 6 PLUS Version 1.0 as an operating 
system base. 


Oo The SNA6 Transport Facility Release 4.0 is requisite 
software for the Remote Job Entry Facility Release 4.0. 


Oo SNA6-RJE consists of the following bound unit: 


- >>LZSNAOZNRIJE 
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MINIMUM REQUIREMENTS/DEPENDENCIES - Continued 
In addition, the following DARTS file is included: 
- >>SIDORJE.TICS 


The following file is used with UPF and the SNA 
configurator directory: 


- P>CCDORJESSTART UP.EC 


Oo Sample RJE configuration files are provided. 


SNA6 INTERACTIVE TERMINAL FACILITY (SNA6-ITF) 


The SNA6 Interactive Terminal Facility Release 4.0 requires 
GCOS 6 MOD 400 Release 4.0 or HVS 6 PLUS Version 1.0 as an 
operating system base. 


Oo The SNA6 Transport Facility Release 4-0 is requisite 
software for the Interactive Terminal Facility 
Release 4.0. 


Oo The Interactive Terminal Facility consists of the 
following bound units: 


—- >>Z4SNA>ZNITF 
~- >>ZSNAZNICOM 


In addition, the SNA6 Interactive Terminal Facility 
Release 4.0 provides the following DARTS file: 


= 77 eo LDOLI fet LCS 


The following file is used with UPF and the SNA 
configurator directory: 


= 2OCCDFLIF cS TART UPC 


oO A sample ITF configuration file is provided. 


SNA6 FILE TRANSFER FACILITY-6 (SNA6-FTF-6) 


The SNA6 File Transfer Facility-6 Release 4.0 requires GCOS 6 
MOD 400 Release 4.0 or HVS 6 PLUS Version 1.0 aS an operating 
system base. 


o The SNA6 Transport Facility Release 4.0 and the SNA6 
Application Interface Facility Release 4.0 are requisite 
software for SNA6-FTF-6 Release 4.0. 


Oo SNA6-FTF-H Release 4.0 is requisite software for 
SNA6-FTF-6 Release 4.0. 
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oO. 


The SNA6-FTF-6 Release 4.0 consists of the following bound 
units: 


- ?P>NFTOQMGR>ICHGUFT 
-~ D2 >NFTOQMGROFTPR 

- PONFTOQMGROFTPS 

~ D>>NFTOQOMGROFTPSS 

-  >>NFTOQMGR>SU SNA 
- >? ONFTOQMGROANFP 

- >PNFTOQMGROZNFTA 

- >P>NFTOQMGROZNFTB 

- D> PNFTOQMGROZNFTSS 
- >>SYSLIB2>SGMBX 


In addition, the following DARTS files are included: 


~-~ >ONFTODARTOS AIF 

-  D>ONFTODARTOSET UP.EC 
- DONFTODARTOTICS ALL 
~-  ?ONFTSDARTOTICS DYL 
- >P>ONFTODARTOTICS NFT 
- PNFTODARTSTICS OM 

- >PNFTODARTSTICS COMM 
-  >ONFTODARTOTICS FP 

- P?ONFTODART>OTICS MB 

~  ?SNFTODARTOTICS KW 

- >>NFTSDARTSBULLSEYE 
- ?PNFTODARTSDART INFO 


The following files for various tools and utilities are 
also included: 


- >>MLOUFT.EN 

- >>NFTSCHANGEHUFT.EC 

- >>NEFTONULL. EC 

- ?P>NFTOSTART NET.EC 

-  DONFTOSTART UFT.EC 

- >?>O>NFTOSTART UP.EC 

- D> ONEFTOSTARTNET. EC 

- D> >NFTOSTARTNETD. EC 

- >>NFT>TOOLS >ABSAO. EC 

- >? >NFT>TOOLS >ABSAO. EC 

- >>NFT>TOOLS >DUMPMEM. EC 
- ?>NFT>TOOLS >HELP-DSA 

-  >>NFT STOOLS >HELP-SNA 

-  D>PNFET>OTOOLS >NPXD.EC 

- P>NFTOTOOLSOSTART UP.EC 
-  DNFT STOOLS SUSUR REG.EC 
- DPNFTOTOOLS >DPEX.EC 

- DONFTOTOOLS SQM F.EC 


MINIMUM REQUIREMENTS/DEPENDENCIES - Continued 


-  >>NFT>AO>ABSAO. EC 

- D>ONFTOQMGROSTART 

—- >O>NFTOQMGROSTART UP.EC 
- >>NFTOQMGROSTATE 

- >>WDD>FILETRAN. EC 


The following files are sample configuration files for 
SNA6-FTF-6: 


~ >>CCDOAIFSSFTNODE.S 
- ?>CCDOAIFSSFTNODE DTA 
- >>CCDOAIFOSFTNODE 


SNA6 FILE TRANSFER FACILITY-HOST (SNA6-FTF-H) 


o The SNA6-FTF-H software is provided by Honeywell on 
magnetic tape in a format suitable for installations using 
IBM's System Modification Program (SMP/4). The tape 
contains eight files: 


FILE 


FILE 


FILE 


FILE 


FILE 


FILE 


FILE 


FILE 


1 
2 


8 


SMP System Modification Control Statements 

SFT Modules 

Source of Customization Tables 

Macros for Customization Tables 

SFT Messages 

Initialization File for VSAM clusters 
Partitioned Data Set (PDS) which contains 
instructions and JCL members needed to 


install the program product. 


PDS containing sample IDCAMS control 
statements for allocating VSAM files. 


Use the JCL that is described in the SNA6 Host System 
Programmer's Guide 
that is referenced throughout the install process and print down 
the instruction document. (Due to changes in the JCL, use manual 
GB88-03 or later.) 


(GB88) to dump file 7 of the tape to a PDS 
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MINIMUM REQUIREMENTS/DEPENDENCIES - Continued 


SNA6 APPLICATION INTERFACE FACILITY (SNA6-AIF) 


The SNA6 Application Interface Facility Release 4.0 requires 
GCOS 6 MOD 400 Release 4.0 or HVS 6 PLUS Version 1.0 as an 
operating system base. 


1@) 


The SNA6 Transport Facility Release 4-0 is requisite 
software for the Application Interface Facility 
Release 4-0. 


SNA6-AIF consists of the following three bound units: 


- >?>>ZSNA>ZNAIF 
- ?>>Z2ZSNA>ZNAPC 
- P>>Z4SNA>ZNATZ 


The following COBOL runtime routines are included in the 
directories >>LDD>ZCART for COBOLA and >>LDD>ZCMRT for 
COBOLM: 


CSACEB.O CSPONR.O 
CSACPT.O CSPTOR.O 
CSALLO.O CS RAW . O 
CSATCH.O CSRECV.O 
CSCASR.O CSRI.O 
CSCNFD.O CSRTOS.O 
CSCONF.O CSSDAT.O 
CSDEAL.O CSSEND.O 
CSEBAC.O CSSERR.O 
CSFLSH.O CSSI.O 
CSGTAT.O- CSSRSP.O 
CSINIT.O CSTERM.O 
CSLEAD.O* CSTEST.O 
CS PHRA.O CSWAIT.O 
CSPHRZ.O CSWANY.O 
CSPOLL.O 


*Included in >>LDD>ZCART only 
The SNA6-AIF emergency dump file is: 
- >>CCDOAIF DUMP 
In addition, the following DARTS files are included: 
- P?>>SIDSAIF P.TICS (for PU module) 


- >>SIDD>DAIF L-TICS (for LU module) 
- >>SID>SAIF C.TICS (for COBOL module) 
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MINIMUM REQUIREMENTS/DEPENDENCIES - Continued 


The following file is used with UPF and the SNA 
configurator directory: 


—- >>CCDOAIFOSTART UP.EC 


The following files are sample configuration files for 
SNA6-FTF-6: 


- >>CCD>AIFSSFTNODE.S 
—- >>CCDOAIFOSFTNODE DTA 
- >>CCDOAIF>SFTNODE 


The following directory contains sample Assembly and COBOL 
application programs for both LU Type 0 and LU Type 6.2: 


- >>CCDOAIFOSAMPLE 


These samples are used in conjunction with host CICS 
Sample applications that are provided by Honeywell. These 
Samples are packaged with AIF as two files (PDS) on 
magnetic tape in a format suitable for installations using 
IBM's IEBCOPY utility. These files are: 


FILE 1: HISAIF4.INSTALL - JCL/Instructions 
FILE 2: HISAIF4.MODULES - Load Modules 


SNA6 REMOTE OPERATOR FACILITY-6 (SNA6-—ROF-6) 


The SNA6 Remote Operator Facility-6 Release 4.0 requires 
GCOS 6 MOD 400 Release 4.0 or HVS 6 PLUS Version 1.0 as an 
operating system base. 


1) 


The SNA6 Transport Facility Release 4.0 and the SNA6 
Application Interface Facility Release 4.0 are requisite 
software for ROF-6 Release 4.0. 


SNA6—-ROF-H Release 


4.0 is requisite software for 
SNA6-ROF-6 Release 4.0. 


SNA6-ROF-6 Release 4.0 consists of the following bound 
units: 


- >?>>4SNA>ZNGSUP 
- >>Z2SNA>ZNGROF 


In addition, the following DARTS files are included: 


- >>SID>SUP.TICS 
- >>SID>ROF.TICS 
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MINIMUM REQUIREMENTS/DEPENDENCIES - Continued 
SNA6-ROF-6 requires the directory: 
- >>CCD>ROF 


The following files are dynamically created and deleted by 
SNA6-ROF-6 (in the >>CCD>ROF directory): 


- USER IN. XX 
- USER OUT. XX 


where XX is the group ID. 


The following files are used with the Interactive 
Configurator for a sample ROF node: 


- >>CCD>AIF>SMPLROF 
- >>CCDOAIF>SMPLROF DTA 


Oo For remote system operators, the system files LOGA and 
LOGB are required. 


SNA6 REMOTE OPERATOR FACILITY-HOST (SNA6-ROF-H) 


Oo SNA6-ROF-H requires the MVS or MVS/XA operating system at 
the host. For information regarding use with other 
Operating systems, contact your Honeywell representative. 


Oo The SNA6-ROF-H software is provided by Honeywell on 
magnetic tape in a format suitable for installations uSing 
IBM's IEBCOPY utility- The tape contains three files: 


FILE 1 - Installation Instructions 
FILE 2 - JCL and Text files 
FILE 3 - Load Modules 


Use the JCL that is described in the SNA6 Host System 
Programmer's Guide (GB88-03 or later) to unload this tape and 
read the text and load modules. 


Memory and Disk Requirements 
SNA6 TRANSPORT FACILITY (SNA6-TF) 


l. A minimum of 72,000 bytes of system memory from the $$ 
pool, plus: 


Oo For each of the two frame sizes configured through 
SOPR., the buffer manager sets up thirty-two buffers 
(example, a 256-byte link sets up thirty-two 256-byte 
buffers). The maximum number of host link buffers 
which are built is sixty-four, i.e. thirty-two for 
each possible frame size (256 or 512). At least 5% of 
available system memory is always left. 
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MINIMUM REQUIREMENTS/DEPENDENCIES - Continued 
o The SDLC Communication Control Program requires 500 
bytes of MLCP space, 594 bytes of MLC-16 space, or 620 
bytes of network communications controller space. 


o The SNA configurator requires 60,000 bytes of user 
memory. 


2- Disk Space - a minimum of 784 sectors 


SNA6 REMOTE JOB ENTRY FACILITY (SNA6-RJE) 
1. A minimum of 54.000 bytes of user memory. 


2. Buffer Pools require a minimum of 3000 bytes of user 
memory and: 


O Each Logical Unit requires 7000 bytes of memory 


o Each output medium Pool entry requires 600 bytes of 
memory 


Oo Each print medium requires 64 bytes of memory. 
3. Disk Space - a minimum of 200 sectors 
SNA6 INTERACTIVE TERMINAL FACILITY (SNA6-ITF) 
1. A minimum of 40,000 bytes of user memory, plus; 


o Buffer Pools require a minimum of 6600 bytes of 
memory, and: 


- Each memory resident Screen Image Buffer (SIB) 
requires 2300 bytes of memory 


- Each Logical Unit (CRT, printer or virtual 
terminal) requires 4600 bytes of memory 


- Each application program requires 240 bytes of 
memory in addition to the application program size. 


2. Disk Space - a minimum of 336 sectors 
SNA6 FILE TRANSFER FACILITY-6 (SNA6-FTF-6) 


SNA6-FTF-6 is also known as DSA6 Unified File Transfer 
Facility (DSA6-UFT). DSA6-UFT supports either a DSA or SNA 
network environment or a combination of both networks. The 
memory requirements depend on the networks used, the options 
selected, and the load. The UFT bound unit runs in a user group; 
the remaining four bound units run in the $X group. Both groups 
run ina user memory pool. 
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* 


Component 


Operator interface 
- Basic Beat | 
~ Bxtoaded: 7 UFT 
Associated workspace Po eens 


Request control 


- Basic UFT 
Associated workspace 
plus per active user 
plus per active request 
or server 
~ Extended UFT 
Associated workspace 
plus per active user 
plus per active request 
Or server 
plus SFT node table where 
n = number of nodes © 


-~ SFT Server only 
Associated workspace 
plus workspace per server request 
plus SFT node table where 
n = number of nodes 


File System interface 
Associated workspace per 
active file accessed 

plus record size 


Requester protocol handler 


Associated workspace per active request 


Server protocol handler 


Associated workspace per active server 


SFT Server Protocol Handler 
Associated workspace per active 
server 
plus SNA RU- where n= RU size 
CKM (requester +/- server) 
where n = 28 x records/interval + 
14 x intervals/file 


CHANGEUFT. EC 


These bound units are used only ina DSA/SNA concurrent 


network environment. 
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ZNFTB™ 


ZNFTA* 


ZNFTSS 


ZNFP 


FTPR™ 
FTPS* 


FTPSS 


ICHGUFT 


Estimate 


13400 
3500 
30600 
4600 


54400 
12800 
2900 
4000 
70700 
12800 
3900 
4000 
6 xn 
37600 


9500 
4000 


595800 
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MINIMUM REQUIREMENTS/DEPENDENCIES - Continued 


FTPSS services SNA6 Release 4.0 requests from an IBM host, 
and it supports only the SNA6-FTF-6 server. FTPS and FTPR 
service DSA6 Release 4.0 nodes. ZNFTA supports Extended and 
Basic UFT. ZNFTB supports only BaSic UFT. If you are using 
ZNFTB, you can use only SUFT. If Basic UFT is used, SNA6-FTF-6 
cannot be used. 


Of the three bound units, ZNFTSS, ZNFTB, and ZNFTA, only one 
will be present in memory at any given time. It remains in 
memory only while SFT-6 has requests for file transfers. When 
SNA6-FTF-6 has not had any requesters for a period of time, the 
bound unit that had been in memory goes away and $X terminates. 
SNA6-FTF-6 does not use any memory until it is needed again. 


The remaining bound units are required only in a DSA/SNA 
concurrent network environment. The UFT bound unit is sharable 
and is loaded only once for all users in that memory pool and is 
present only during the time a user is making requests. There is 
an associated workspace for each user that is actively making a 
request. 


ZNFP is present only while UFT is accessing the file system 
on the local node. FTPR is loaded only once for all active 
requestors (requests originating at the local node). FTPS is 
loaded only once for all active servers {requests originating 


from another node). The workspace for both FTPR and FTPS is ona 
per active request basis. 


SNA6-FTF-6 requires a minimum of 2720 sectors of disk space 
for an SNA-only network environment. An additional 464 sectors 
of disk space are required for a DSA/SNA concurrent environment. 
SNA6 FILE TRANSFER FACILITY-HOST (SNA6-FTF-H) 


1. A minimum 768,000 byte region for the File Maintenance 
Utility. 


2. A minimum 768,000 byte region for the Transmission 
Control Program. 


3. Disk space - 8 cylinders of 3380 space 
SNA6 APPLICATION INTERFACE FACILITY (SNA6-AIF) 
lL. A minimum of one of the following: 


Oo 32,600 bytes of user memory, which includes one Type 0 
LU- plus 


- 1100 bytes of user memory per additional LU 


19 GZ68-02 


37,600 bytes of user memory, which includes one Type 
6.2 LU- plus . | 


- 1100 bytes plus maximum RU size of user memory per 
additional LU 


43,600 bytes of user memory, which includes one Type 0 
LU and one Type 6.2 LU, plus 


- 1100 bytes of user memory per additional Type 0 LU. 
plus | 


- 1100 bytes plus maximum RU size of user memory per 
additional Type 6.2 LU 


2. Disk space - a minimum of 192 sectors 


SNA6 REMOTE OPERATOR FACILITY-6 (SNA6-ROF-6) 


1. A minimum of 47480 bytes of user memory, plus the 
following: 


O 


O 


474 bytes for each LU (minimum of 2 LUs) 
56 bytes for each ROF terminal user 


1548 bytes for the correlation table (1 table required 
for each 256 users) 


968 bytes for the control table 
3576 bytes for the task request block structures 


256 bytes for each transmission buffer (maximum of 10 
concurrent) 


A unique task group with the EC processor as the lead 
task. | 


2. Disk space - a minimum of 288 sectors. 


SNA6 REMOTE OPERATOR FACILITY-HOST (SNA6-ROF-H) 


1. Memory--A minimum 25-500-byte region 


2. Disk space - 3 cylinders of 3380 space 
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DOCUMENTATION 


The software reference manuals listed below document SNA6 
Release 4.0 products: 


SNA6 Transport Facility (SNA6-TF) - SHC192 


CR56-03 IBM DDP Overview 

CR57-04 SNA6 Network Configuration 

GB88-03 SNA6 Host System Programmer's Guide 
GX10-01 SNA6 Operator's Guide 


SNA6 Interactive Terminal Facility (SNA6-ITF) -— SHC194 


CR5 8-02 SNA6 Interactive Terminal Facility User's 
Guide 7 


SNA6 Remote Job Entry Facility (SNA6-RJE) - SHC196 
CR59-02 SNA6 Remote Job Entry Facility User's Guide 
CRO60-02 SNA6 File Transfer Facility User's Guide 
SNA6 Application Interface Facility (SNA6-ITF) - SHC282 
GR11-02 SNA6 Application Programmer's Guide 
SNA6 Remote Operator Facility-6 (SNA6-ROF-6) - SHC294 
GX11-01 SNA6 Host System Operator's Guide 


Note: If you order SNA6 (SHC225) you will receive all of 
these manuals. 
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DOCUMENTATION - Continued 
IBM Manuals 


Refer to these IBM documents for host programming, operating, 
and configuration information: 


Order No. Manual Titie 

GA27-3136 SNA Reference Summary _ 

SC23-0046 JES2 Initialization and Tuning 

SC27-0164 ACF/VTAM Messages and Codes 

SC27-0449 ACF/VTAM Programming 

SC27-0611 ACF/VTAM Planning and Installation Reference 

SC30-3167 ACF/NCP Installation and Resource Definition 

SC30-3168 ACF/NCP System Support Programs: Utilities 

SC30-3169 ACF/NCP and Emulation Program: Messages and 
Codes 

SC33-0149 CICS Resource Definition Guide 
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PRODUCT EXCEPTIONS AND ITEMS FOR EMPHASIS 


Exceptions are items of functionality that are 
not in conformance to the product's definition, 
but are expected to be corrected. These 
exceptions are also documented in the product's 
problem tracking system. Items for emphasis are 
those key areas where product usage is 
explained. 


Current Exceptions 


KPF Number G06380 
Subject Name: SFT | 
Description: Using the CHECKPOINT option for "sending" 


files is restricted. However, a patch is 
available under this KPF# that allows 
CHECKPOINT to be used for "receiving" files. 


KPF Number: G06381 
Subject Name: AIF 
Description: AIF is restricted to a maximum of 50 LU 


sessions (total of LU 0 and/or LU 6.2). 


KPF Number: G06382 
Subject Name: SFT 
Description: In low memory Situations, misleading or 


unexpected error messages can occur while 
SFT-6 is recovering. If low memory 
conditions occur frequently, reconfigure with 
additional memory in the AB pool. 


Items for Emphasis 
SNA6 TRANSPORT FACILITY (SNA6-TF) 


1. Within the directory >>CCD, files and/or node names 
cannot contain the suffix ' UPD', ' UPX', or ' DTA'. The 
use of these suffixes conflicts with internal SNA6 naming 
schemes. 


2. The user should create groups with the appropriate 
person.project.mode, as follows: 


AIF = SNA.AIF.SNA 
ITF = SNA.ITF.SNA 
RJE = SNA.RJE.SNA 
ROF = SNA.SUP.SNA 
SFT = UFT.DAEMON 


If you execute from another group, you should set the 
appropriate ACLS on PRIV GROUP and PRIV2. 
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PRODUCT EXCEPTIONS AND ITEMS FOR EMPHASIS ~ Continued 


3. Listenur terminal support 


The SNA6 System Administrator has the following 3 options 
for supporting execution of SNA6 program products via 
Listenur terminals (typically the configurator and RJE): 


O 


Register each user with the user id of the installed 
product (e.g., SNA.RJE.SNA). The user LOGIN ID and 
PASSWORD are not altered. 


Set an ACL on each of the system-defined files 
(PRIV GROUP, PRIV2. and PRIV1) for each user id. This 
procedure does not require a user to be re-registered. 


Login as the SNA6 system administrator and execute the 
desired SNA6 program product. 


4. Product configuration files created for the SNA6 
Release 1.2 products must be recreated for use in the 
Release 4.0 environment. 


5. The Transport Facility does not SHUTDOWN until all 
program products and AIF applications have terminated. 


SNA6 REMOTE JOB ENTRY FACILITY (SNA6-RJEF) 


1. SNA6-RJE requires 4 LRNsS and up to 10 LFNs per LU. 


2. The following are not supported: 


O 


O 


T Type data and exchange data 


RSHD command 


Magnetic Tape 


Preconfigured logon, preconfigured INPT files, and 
preconfigured medium/subaddress. 


The SOPR commands ABORT, STOP, and SHUTDOWN are not 
honored until the user enters the next RJE command at 
the RJE workstation terminal. 


SNA6 INTERACTIVE TERMINAL FACILITY (SNA6-ITF) 


l- Each time the remote printer is being restarted, the 
ACQUIRE (printer) command must be executed by the host 
Operator. 
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EXCEPTIONS AND ITEMS FOR EMPHASIS - Continued 


~eareras seen RHO HOT ER ABA hPa PA SE =P iTS PTE EAP A Pi RARER ET ROSAS ERE SAN ACRE ante, NEEM 


6. 


ITF does not prevent host-initiated unsolicited screen 
writes. 


Depending on the host application, data being entered may 
on rare occasions be overwritten by the host prior to 
data entry completion. User action is dependent upon the 
particular host application being used. 


ITF requires the configuration of 10 IRBs per LU. 


If ITF encounters a serious protocol violation and cannot 
resolve it, the LU session is suspended and the terminal 
is returned to Listenur. If a user tries to log in to 
that LU- ITF returns a 5B54 message and rejects the 
login. However, the terminal user can log in toa 
different LU. The LU SuSpension is done for debugging 
purposes. The user should take a group memory dump. 
(Submit the dump to your Honeywell representative.) If 
the user needs to recover the LU, do a SA abort of the 
node. If the group that the node ran in does not go back 
to ready (RDN) state, do a SS abort of that task group. 
Then spawn the group and reinvoke the ITF. 


To fully take advantage of ITF's dynamic LU 
configuration, a dynamically spawned class 2 virtual 
application must issue a return code of X'07' to ITF 
Signifying its final return. This instructs ITF to 
delete the task, restore the LU to itS original class, 
and release the LU for use. This return code should be 
sent after the application has logged off the host 
application, terminated the session, and received the 
unbind. 


ITF does not support the Response Time Monitor. 


SNA6 FILE TRANSFER FACILITY-6 (SNA6-FTF-6) 


dive 


2% 


3. 


Save file transfers (i.e., files that use control 
intervals) are not supported. 


In order to read and write files to disk, you must 
provide access to the following default person.project on 
any file that is to be transferred: 


UFT.user. * 
A sample batch AIF configuration file for SFT-6 is 
provided in >>CCD>AIF>SFTNODE.S. The default start file 


(>>NFT>QMGR>START) uses this sample configuration for the 
initial local node name. 
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PRODUCT EXCEPTIONS AND ITEMS FOR EMPHASIS - Continued 


42. If SFT-6 is to EXECUTE an Enter Batch Request command for 
an EC file, the CLM entry for SB requires a secondary 
name. For example, if the original CLM entry is 


MEMPOOL B,,i0000 
change it to 


MEMPOOL I,BT,10000 
MEMPOOL B,,BT 


SNA6 FILE TRANSFER FACILITY-HOST (SNA6-FTF-H) 


1. To migrate to SNA6 Release 4.0, first migrate the 
SNA6-FTF-H package. 


2. SMP/E compatibility is not present on the host load tape. 


3. SNA6-FTF-H does not Support host files with undefined 
record lengths. 


4. When staging or dynamically allocating new files for the 
SFT-6 system from the host, always define the record 
length (RECL) parameter in the STAGE or ADDACT statement. 


5. When coding the SFTTCP EXEC statement, the PARM parameter 
should specify blocking for outbound transmissions 
(BLKOUT=ENABLE). If unblocked mode is desired, 
especially when transmitting small record sizes, set the 
pacing for NCP to LU seSSions at a low value. 


SNA6 APPLICATION INTERFACE FACILITY (SNA6-AIF) 


1. AIF user-written applications do not require a privileged 
group. 


2. With LU type 0 assembler applications, programmers have 
options in managing 'waits' for multiple requests. 


o If the SWAITL macro (wait on list) is used, then AIF 
requests must be subtasked. 


o If you wish to use the Wait Any function, the 
application program should use the AIF session call 
SSWANY and must never execute the SWAITA macro. 


In the latter case, the P-bit in non-AIF request blocks 
must be set by the caller before executing a SSWANY. If 
a task has more than one active AIF session, that task 
must never execute a SWAITA call. 
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PRODUCT EXCEPTIONS AND ITEMS FOR EMPHASIS —- Continued 


3. The following sequence occurs in the event that AIF 
detects an unrecoverable user program error: 


a. The application program is informed that the sesSion 
has been aborted (RCPGER or VRPGER). 


b. An emergency dump (DPEDIT of the AIF node's task 
group) is put into the file >>CCD>AIF DUMP and a 
system operator message is displayed and journaled. 


c. The host is directed to terminate the session. The 
affected LU becomes available for assignment to other 
users. 


AIF DUMP was created by the install EC with a maximum 
size of 4500 CIs. The number of DPEDITs that fit into 
this file is determined by the SNA6 configuration being 
dumped (AIF limits itself to ten (10) dumps); that is, 
the more LUS being configured, the larger the dump. 


The install EC command used to create the file is: 
CR >>CCDOAIF DUMP -GRSZ 1000 -MxXSZ 4500 


You may wish to alter the maximum size of your file to 
accommodate your installation's file space needs. The 
MODIFY FILE command can be used to change the maximum 
file size. This file should be printed and forwarded to 
your local Honeywell representative for analysis, then 
deleted in order to conserve file space. If you delete 
the file and do not recreate it, AIF automatically 
creates the file if it is needed for an emergency dump, 
but the new file is created without a maximum Size. 


The START UP.EC should include directives to test for the 


existence of >>CCD>AIF DUMP and print and delete its 
contents. 


4. For LU Type 6.2 to accept an unsolicited BIND, this LU 
must be configured as RESERVED. 


SNA6 REMOTE OPERATOR FACILITY-6 (SNA6—-ROF-6) 

1. If the system files LOGA and LOGB are not open when a 
system operator is invoked, ROF assumes that the files 
have been created in the directory >>SID and attempts to 
open them. 


2. All users must be registered on the DPS 6 or DPS 6 PLUS 
sytem. 


SNA6 REMOTE OPERATOR FACILITY-HOST (SNA6-ROF—H) 
1. SMP-E compatibility is not present on the host load tape. 
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APPENDIX A ERRATA 


SNA6 Host System Programmer's Guide (GB88) 


Change BLKOUT=NO to BLKOUT=DISABLE in Figure 6-l. 


2. Page 6-6. 
Change BLKOUT=(YES,NO) to BLKOUT=(ENABLE,DISABLE). 
The default is DISABLE. 


3. Page B-3 and Page B-4. 


Replace the subsection entitled "Files Common to 
GWIF-HOST and ROF-H" with the following: 


FILES COMMON TO GWIF-HOST AND ROF-H_ 


Both GWIF-HOST and ROF-H require the IBM host system 
administrator to create a user validation (ID/password) file and 
a routing information (configuration) file. The user validation 
file is a collection of records that provide the first level of 
security for the DSA network or SNA6 node in the SNA network. 
The routing information file is a collection of records that 


define communication paths from the host to the target system and 
application. 


File Characteristics - User Validation File 


eae me aoe 


User validation files are VSAM KSDS (key sequence data set) 
files and have the following characteristics: 


Oo Records are in a fixed position and fixed field 
format. 


o All fields must be filled from the first character 
position. Unused character positions must be 
blank-filled. 


o The first field of each record is used as the key to 
that record. Records must be entered in EBCDIC 
collating sequence by this (first field) key. 

File Characteristics - Routing Information File 


Routing information files are VSAM ESDS (entry sequence data 
set) files and have the following characteristics: 
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o Each record statement must begin with an object 
identifier CO, CG, CR, RC, CLU., or GLU in column one 
of the statement. (Record objects are described 
later in this section.) 


fe) Each keyword must begin with a hyphen (-). 


© In each record, the object identifier, object name, 
keywords, and keyvalues must be separated by one or 
more blanks. (In GLU records, if multiple LU names 
are used to define keyword -INLU or keyword -OUTLU, 
the LU names must be separated by a comma.) 


o The maximum logical record size is 80 characters. 
However. statements can be continued, by placing an X 
(or any non-blank character) in column 72 and 
continuing the statement in column 16 of the next 
line. Records can be continued between keywords 
only. 


o An asterisk (*) in column one of a record denotes a 
comment line. 


4 e Page C-l © 
Delete Destination Control Table (DCT) from the list 
of CICS tables requiring entries. 


5. Page C-l and Page C-2. 
Delete the subsection entitled "Destination Control 
Table Entries." 


6. Page C-2. 
Delete Figure C-l. 


Replace the subsection entitled "File Control Table 
Entries" with the following: 


FILE CONTROL TABLE ENTRIES 


GWIF and ROF share two VSAM KSDS files and one VSAM ESDS 
file. The KSDS files are: a message file and a user validation 
(ID/password) file. The ESDS file is a routing information 
(configuration) file. The message file is supplied with the 
installation material. The user validation file and the routing 
information file must be defined by the host system | 
administrator. (Refer to Appendix B.) Sample validation and 
configuration files are supplied with the installation material. 
| A separate FCT entry is required for each of these files. 
Figure C-2 shows sample DFHFCT macros used to generate the 
entries. | 
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8. 


Page C-3. 
Add the following macro to Sagues C-2, "Sample FCT 
Definition". 


* 

* 

* DEFINITION MACRO FOR ROUTING CONFIG. FILE 

* 

HISCONFG DFHFCT TYPE=DATASET, ENTRY DESCRIBES A FILE 
DATASET=HISCONFG, SYMBOLIC, ACB, DD NAME 
ACCMETH= (VSAM, ESDS) , VSAM ENTRY SEQUENCE FILE 
SERVREQ= (BROWSE), BROWSE ONLY 
FILSTAT=(ENABLED,OPENED), ENABLE AND OPEN AT CICS START 
RECFORM=VARIABLE, VARIABLE LENGTH RECORDS 
RSL=PUBLIC, NO SECURITY CHECK ON RESOURCE 
BUFNI=2, # BUFFERS FOR THIS FILE 
STRNO=1 # STRINGS (CONCURRENT REQUESTS) 


SNA6 Interactive Terminal Facility User's Guide (CR58) 


1. 


Page 3-14. 
Delete the subsection entitled "Using the Last 
Transaction Time Indicator." 


Page 3-39. 
Delete the LTTI function from Table 3-3. 


Page 3-40. 
Delete the LTTI function from Table 3-4. 


Page 3-4l. 
Delete the LTTI function from Table 3-5. 


Page 3-43. 
Delete the LTTI function from Table 3-6. 
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